MoveBefore

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODFacet

MoveBefore
The MoveBefore method repositions an embedded facet of this facet in front of a sibling facet.
void MoveBefore (in ODFacet child,
                 in ODFacet sibling);
child
A reference to an embedded facet to be repositioned.
sibling
A reference to a sibling facet that is to be directly behind the embedded facet. If the value is kODNULL, the embedded facet is repositioned in front of all its sibling facets.

DISCUSSION
After this method executes successfully, the sibling order associated with the embedded facets may or may not have changed. Any changes to the sibling order of the embedded facets are reflected in the facet iterator, if a facet iterator exists.
While you are using a facet iterator, you should not call this method to modify the list of embedded facets. You must postpone repositioning facets in the list of embedded facets until after you have deleted the iterator.

EXCEPTIONS

kODErrInvalidFacet
The child or sibling facet is not an embedded facet of this facet.

SEE ALSO
The ODFacet::MoveBehind method (page 254).
"Maintaining a List of Embedded Facets" on page 149 in OpenDoc Programmer's Guide.